Les documents Rmd : Word Killer ?

AfromapR Bouaké 2025

Auteur·rice

Claude Grasland & Jean-Paul Nguesso

Date de publication

2025-05-27

Excel
Télécharger l’exercice

Objectif

Nous venons de voir comment une bonne pratique de R peut conduire progressivement à abandonner l’usage des tableurs (Excel, Open Office) sauf peut-être pour l’étape de saisie des données. Dès lors qu’il s’agit de réaliser des graphiques ou des calculs statistiques complexes, la rédaction d’un programme se révèle beaucoup plus intéressante même si elle impose un coût initial d’apprentissage.

Mais une bonne pratique de R ou plus précisément des documents R markdown peut vous conduire beaucoup plus loin et vous amener à abandonner également votre logiciel de traitement de texte (Word) et votre outil de présentation (Power Point). Le coût d’apprentissage est naturellement un peu plus élevé mais les bénéfices sont à la mesure de l’investissement.

Comme le montre la figure ci-dessous, un document R markdown est en quelques sorte un mélange entre des lignes de code R qui executent des tâches et des lignes de texte où sont expliqués les calculs et commentés les résultats obtenus. En d’autres termes, un document R markdown vous permet de rédiger un article de recherche complet, une présentation à une conférence, un syllabus de cours, dans un seul environnement logiciel (R studio).

Programme R

Nul besoin de ciseau et de colle pour aller chercher tel tableau ici, tel figure là-bas ou telle carte ailleurs. Tous ces éléments sont intégrs au fur et à mesure de la rédaction ce qui facilite considérablement la concentration. Et surtout - on l’a déjà vu pour le programme R - le document peut facilement être reproduit ou mise à jour sans être obligé de réplique des dizaines de click de souris.

Document .Rmd

On va supposer que l’on veut transformer notre programme d’analyse des inégalités régionales en rapport qui sera imprimé ensuite au format word ou pdf.

Préparation du document Rmarkdown

On ouvre le projet précédent où se trouve déjà notre programme R

Programme R

A l’intérieur de ce projet, on crée un document de type Rmd (R markdown) auquel on donne le titre “Inégalités de développement en Côte d’Ivoire en 2002” et on le sauvegarde sous le nom Rapport_CIV_2022.Rmd.

Au moment de l’ouverture, le document ressemble à ceci:

Programme R

On garde le premier bloc de programme (en gris) et on élimine toute la partie créée par Rstudio pour servir d’exemple. On la remplace par notre plan en utilisant des instructions pour hiérarchiser les parties (##) , sous-parties (###) et sous-sous parties (####). On évitera d’utiliser (#) qui correspond à un titre de chapitre ou d’ouvrage.

Programme R

On clique alors sur le bouton “Knit” (une pelotte de laine bleue) pour visualiser le résultat qui s’affiche sous la forme d’une page .html.

Sortie html

Combinaison de texte et de code

On va maintenant pouvoir rédiger notre document en alternant des parties de texte (rédigées en langage markdown) et des blocs de code R appelés chunks

Ajout d’un tableau

On décide d’ajouter un tableau de données :

Programme R

Voici le résultat dans la page .html

Sortie html

On décide d’ajouter un résumé des variables

Programme R

Voici le résultat dans la page .html

Sortie html

Ajout de graphiques

On veut ensuite insérer deux histogrammes regroupés en une seule figure

Programme R

Voici le résultat dans la page .html

Sortie html

Puis on ajoute un diagramme de relation entre deux variables

Programme R

Voici le résultat dans la page .html

Sortie html

Ajout d’un test régression

On termine en ajoutant un test de corrélation entre les deux variables.

Programme R

Voici le résultat dans la page .html

Sortie html

Exportation